home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Fritz: All Fritz
/
All Fritz.zip
/
All Fritz
/
FILES
/
UTILFILE
/
DISKLIST.LZH
/
DISKLIST.DOC
< prev
next >
Wrap
Text File
|
1991-04-23
|
51KB
|
1,213 lines
D I S K L I S T
Prints a Directory Listing on any Printer
DISKLIST is a commercial program and is copyrighted.
It is distributed using the Shareware marketing
concept. The Shareware concept allows you to try the
fully functional program on your own computer before
you buy it. If you continue to use DISKLIST or keep
it for when you might use it, then you MUST send the
$25 registration fee to the author. Press F to print
the registration form from the program.
When you register DISKLIST you will receive:
Telephone and mail support.
A copy of the latest version of DISKLIST
Removal of Registration Screen & reminders.
Skip the Help screen at the start of the program.
Skip the Registration Form reminder at the end
of the program.
A loan amortization program with both the
BASIC source code and the compiled
program. No registration is required for
the amortization program.
Copies of PC-ACCOUNT and SHERLOCK for you
to try before registering.
_______
____|__ | (R)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
Table of Contents
OVERVIEW...............................1
FASTSTART..............................2
OPERATION..............................3
PARAMETERS and COMMANDS................4
LIST FORMATS...........................6
NONLASER PRINTER CONTROL CODES.........8
LASER COMMANDS........................10
LASER DOWNLOAD........................12
TEXT INPUT............................12
STATUS MESSAGES...................... 13
MONOCHROME MONITOR....................13
SUMMARY OF NON-DISPLAYED COMMANDS.....14
FILENAMES............................ 14
DISKFLAP..............................15
SHAREWARE............................ 16
EPILOGUE..............................17
COMMERCIAL LABELS.....................17
OMBUDSMAN............................ 18
IBM GRAPHICS EXAMPLE..................19
Copyright 1991
John P. Bauernschub, Jr.
Gulf Sierra
14809 Clavel Street
Rockville, MD 20853
301-460-0354
CompuServe ID 73270,77
OVERVIEW
DISKLIST is designed to print the directory of any disk,
including subdirectories, on a stick on label, a sheet of paper
that can be cut to the size of the diskette, on an 8.5 x 11
sheet, the screen, or a disk file. The list is in a format that
is the size of the floppy so that it can be attached to the
floppy, or, if on paper, trimmed to fit into the floppy sleeve.
DISKLIST lists the contents of all of the subdirectories on the
disk. DISKLIST provides an easy method to configure the output.
Here is an example of one form of the output of DISKLIST.
--------------------------------------------------
| GREAT SHAREWARE |
| Volume ID is DISKLIST |
| 1,457,664 Total Space 893,440 Bytes Free |
|------------------------------------------------|
| A:\ 153,664 BYTES |
| DISKLIST.DOC 34,377 08/15/90 19:32:16 |
| DISKLIST.EXE 119,144 08/14/90 22:02:18 |
| DISKLIST.PRM 124 03/25/90 11:11:48 |
| DISKLIST.TTL 19 03/25/90 11:05:06 |
| |
| A:\PC-ACCOU.NT 230,862 BYTES |
| PCACT220.EXE 156,150 11/08/89 19:03:52 |
| PCACT220.TXT 6,838 11/09/89 18:30:42 |
| PCDOC220.EXE 67,874 11/08/89 19:09:22 |
| |
| A:\SHERLOCK 175,967 BYTES |
| SHERLOCK.DOC 30,895 08/15/90 19:35:14 |
| SHERLOCK.EXE 145,072 08/15/90 19:44:04 |
|------------------------------------------------|
| 9 Files 08-17-1990 18:46:00 |
| |
| |
| |
| |
| |
| |
| |
| Created by DISKLIST |
--------------------------------------------------
This example is in the 5.25 inch normal format for that size
diskette. DISKLIST can also print it in the 3.5 inch compressed
format for the 3.5 inch diskettes, or in the 8.5 x 11 inch page
format. There are 33 formats for you to chose from, all easily
selectable from the DISKLIST control window. They contain from 1
to 6 columns of filenames.
ASCII lines were selected for the frame of this display so that
it would print properly on all printers. If your printer can
-1-
print the IBM graphics characters (lines, boxes, etc.) then you
can select IBM (unbroken) lines for your list and the frame will
be smooth single or double lines. Such an example is given on
the last page of this manual. Or you can select a format without
any lines.
Half of the formats do not have any border lines to save space so
that you can print on stick on labels. They are identified with
Label or Lab in the Format Size. Labels also leave off the
'Created by DISKLIST'.
Printer control codes can in inserted in the program. The length
of the label in lines can be set. In the label mode, DISKLIST
will space to the next label. Each format has its own set of
laser commands. All setup parameters can be saved.
FAST START
To run DISKLIST, just enter DISKLIST at the DOS prompt. Read the
Shareware screen carefully, then press RETURN. The control
window and Help window are displayed. Read the Help window for
instructions on how to navigate the DISKLIST control window.
Press any key to close the Help window, it's available anytime by
pressing H. If you are using a monochrome monitor, press M to
toggle on an arrow to indicate the selected parameter. Setup the
parameters as you want them, then press P to print a list.
When registered, the program will skip the Shareware screen and
the help window and be immediately ready for business. After you
have used DISKLIST, enter the F command to print the registration
form, fill it out and send it with $25 to the program author.
Thanks.
When DISKLIST starts, it assumes that you want to print the
directory of the default drive. This is easily changed from the
DISKLIST control window in the program by selecting the first
parameter and pressing the right or left arrow keys.
You can also select the source directory drive from the DOS
command by entering the drive letter (colon not necessary). For
example, if you were going to print the directory of drive A: and
your default drive is C:, then the command would be:
DISKLIST a
-2-
OPERATION
When DISKLIST runs it reads several data files. These files must
be in the same directory as DISKLIST.EXE. If your operating
system is DOS 3.3 or above, you can run DISKLIST from any
directory and it will find its data files. For older versions of
DOS, make the directory DISKLIST.EXE is in the default before
running it.
To run DISKLIST, just enter DISKLIST at the DOS prompt. After
the Shareware screen, the DISKLIST control window will appear.
Parameters D I S K L I S T Commands
===================================================================
1 - Disk Drive A: H or F1 - HELP A - Space Yes
2 - Filespec *.* P - Print List Z - ZIP No
3 - Sort Files by Name L - Line Feed E - Eject Page
4 - Sort Direction Ascending D - Save DISKLIST Parameters
5 - Display on the Laser Printer S - Save Title on Disk Drive
6 - Format 5 Normal R - Read Title from Disk Drive
7 - Border Line Type ASCII |---| F - Print Registration Form
8 - Lines Per List 30 C - Configuration
9 - Title for List F10 or ESC - Quit DISKLIST
The List Title is Displayed Here
Illustration of the Control Window
Press Function Key 1 or H to display the following help window.
H E L P
======================================
Select Parameter or Digit
Change Parameter or Space Bar
Select Command Press Letter
ESC Erase text input line
Press any key to resume
If you printed this documentation on your printer and the
characters before 'or Digit' did not print, they are the up and
down arrows for the cursor control. Likewise the characters
before 'or Space Bar' are the left and right arrows. To see how
this window really looks with the graphics characters, run
DISKLIST and press Function Key 1 to see the Help window.
The words Parameters and Commands on the control window only
appear when the HELP window is active.
-3-
Select a parameter by entering the sequence number of the
parameter, or move the highlight with the up and down arrow keys.
Change the parameter by scrolling through the allowable values
with the left and right arrow keys or the space bar. If you are
using a monochrome monitor, press M to toggle on an arrow to
indicate the selected parameter.
Be sure to select the proper printer (Laser or Nonlaser) with
parameter 5. Then press D to save the parameters. A common
problem is to have the wrong control codes sent to the printer
because the wrong printer was selected.
When parameters 2, 8 or 9 are selected, a window will open up for
text entry. Press ESC to delete the previous entry, or edit it
with the standard editing functions. Insert also works. When
the entry is complete, press the up or down arrow key or RETURN.
The input window will disappear. The title will be displayed at
the bottom of the control window. If you completed the entry
with a RETURN, the highlight will stay on the parameter. Use the
left or right arrow key to reopen the window.
To execute a command, press the command letter when no other
window is open.
PARAMETERS and COMMANDS
DISKLIST lets you configure your directory lists to your
requirements. You can save this configuration as the default
with the D command. The configuration file will be automatically
read the next time DISKLIST is run.
The parameters permit you to:
Select any disk drive - floppy, hard, or ram disk.
Provide a file selection specification, Filespec.
Sort files by name, date, extension, size, or no sort.
Sort direction - ascending, descending.
Display on a laser printer, a nonlaser printer, the
screen, or write to a file.
Select a form and print size - 33 formats available
Select a border line type - None, ASCII dashes, IBM single
or double lines.
Change the number of lines to be printed on the list.
Enter a title for the list.
Read the list of commands from the Control Window figure. Most
are self explanatory. The others are discussed below.
There are two printer modes. One is for nonlaser (mechanical)
printers and the other for laser printers. The difference has to
-4-
do with which set of control codes DISKLIST sends to the printer.
The control codes for mechanical printers are saved with the
general setup parameters in the file DISKLIST.PRM and the laser
printer commands are saved in DISKLIST.LSR. These will each be
discussed separately.
As you move through the Format selections with the right and left
arrows, the Lines Per List data will change to reflect the value
for that size parameter. When the Lines Per List parameter is
selected, a window pops up for entry of the new value. The
original value that came with DISKLIST is in parens for your
reference.
When DISKLIST prints a list that is physically longer than the
diskette, either 5.25 or 3.5 inches, it will put marks on the
border indicating where to fold the paper to neatly match the
disk size. In the ASCII border line type there is a - instead of
the |. In the IBM border line type the horizontal tick mark is
part of the vertical line and is harder to notice, but it is
there. The line this prints on is determined by the value for
Lines Per Inch.
The border line type selection does not apply when the 8.5 X 11
Page, any label format, or the Display on the File is selected.
There are no borders on the 8.5 x 11 Page, Label or File outputs.
All of the borders are available on the output to the Screen.
None of the compressed or multiple column modes are available
when the output is directed to the Screen or File.
For the nonlaser printer, when a mode that uses compressed print
is selected, DISKLIST combines the codes for compressed on and 8
lines per inch (in that order) and prints a line with those
codes. This will cause the printer to advance one line.
Likewise, on completion of the list printing, another line with
the codes for compressed off and 6 lines per inch will be
printed. These two blank lines are included in the number of
lines per list for the nonlaser printer. So, you can put any
codes in these parameters. There is no limit to the number of
codes you may use. When a non compressed format is selected, no
codes are sent to the printer.
For a laser printer, the laser commands are always sent. There
is a set of laser commands for each format.
The printer mode with the 8.5 x 11 Page format and the File mode
are ideal for producing a list of all files on a hard drive and
saving the list in a loose-leaf notebook.
The C command pops up a Configuration menu for selecting the
Nonlaser Printer Control Codes (F5), the Laser Commands (F6), the
Format editor (F7), the date format selector, or to download a
font (F3). You may bypass this menu and go directly to these
-5-
functions from the control window by pressing the associated
function keys.
The format of file dates can only be changed from the
Configuration menu. Press 4 until the date format you want to
use is displayed. The date formats are:
MM/DD/YY DD/MM/YY YY/MM/DD
MM-DD-YY DD-MM-YY YY-MM-DD
MM.DD.YY DD.MM.YY YY.MM.DD
Save your date format from the main control window with the D
command.
DISKLIST will save the title for a disk in a file on that disk
with the S command and retrieve it with the R command. DISKLIST
also prints the disk volume name at the top of the list.
The E command (Eject Page) sends a form feed to the printer. The
L command (Line Feed) sends a carriage return to the printer.
CTRL R or CTRL E sends the laser printer Reset command, ESC E, to
the printer (it is not listed on the control window). When these
commands are sent, DISKLIST acknowledges by beeping. If the beep
is annoying, press CTRL B to turn the beep off, then D to save
this parameter in the parameter file (DISKLIST.PRM). Another
CTRL B will turn the beep on.
Before DISKLIST prints the name of a subdirectory, it prints a
blank line. The blank line can be avoided by toggling the
status of Space to No by pressing the letter A. See the upper
right corner of the control window.
Notice the Z - ZIP in the upper right corner of the control
window. It signifies the status of DISKLIST reading the file
directory in ZIP, ARC, PAK, ZOO, and LZH files. These file names
are displayed in lower case letters to signify that they are from
an archive. Pressing Z toggles the status of this function
between Yes and No.
LIST FORMATS
DISKLIST provides a large selection of list layouts. Some
contain all the file information, name, size, date, and time.
Others contain only the name, or the name and date, or the name
and size. You may have from one to six columns of file names on
a list. Remember, Label formats do not print any border lines
and they skip to the beginning of the next label. They also do
not print Created by DISKLIST.
The following table lists all of the Formats and indicates which
use the compressed mode.
-6-
Sized for
Format Diskette Columns Info Printed Pitch Type
8.5 x 11 Page 1 Name Size Date Time List
3.5 Compressed 3.5" 1 Name Size Date Time Compressed List
3.5 Comp Label 3.5" 1 Name Size Date Time Compressed Label
3.5 2 & Size 3.5" 2 Name Size Compressed List
3.5 2 & Size Lab 3.5" 2 Name Size Compressed Label
3.5 2 & Date 3.5" 2 Name Date Compressed List
3.5 2 & Date Lab 3.5" 2 Name Date Compressed Label
5.25 Normal 5.25" 1 Name Size Date Time List
5.25 Norm Label 5.25" 1 Name Size Date Time Label
5.25 Compressed 5.25" 2 Name Size Date Time Compressed List
5.25 Comp Label 5.25" 2 Name Size Date Time Compressed Label
5.25 2 & Size 5.25" 2 Name Size List
5.25 2 & Size Lab 5.25" 2 Name Size Label
5.25 2 & Date 5.25" 2 Name Date List
5.25 2 & Date Lab 5.25" 2 Name Date Label
5.25 3 & Size 5.25" 3 Name Size Compressed List
5.25 3 & Size Lab 5.25" 3 Name Size Compressed Label
5.25 3 & Date 5.25" 3 Name Date Compressed List
5.25 3 & Date Lab 5.25" 3 Name Date Compressed Label
5.25 4 & Size 5.25" 4 Name Size Compressed List
5.25 4 & Size Lab 5.25" 4 Name Size Compressed Label
5.25 4 & Date 5.25" 4 Name Date Compressed List
5.25 4 & Date Lab 5.25" 4 Name Date Compressed Label
3.5 3 Across 3.5" 3 Name Compressed List
3.5 3 Across Lab 3.5" 3 Name Compressed Label
5.25 3 Across 5.25" 3 Name List
5.25 3 Across Lab 5.25" 3 Name Label
5.25 4 Across 5.25" 4 Name Compressed List
5.25 4 Across Lab 5.25" 4 Name Compressed Label
5.25 5 Across 5.25" 5 Name Compressed List
5.25 5 Across Lab 5.25" 5 Name Compressed Label
5.25 6 Across 5.25" 6 Name Compressed List
5.25 6 Across Lab 5.25" 6 Name Compressed Label
The format to use is selected with item 6, Format, on the control
window. There are over 30 selections.
The display at the bottom of the control window screen displays
information from the above table. It explains the selected
format in more detail. Columns are the number of groups of data
that are printed on a line and Info Printed is the data in each
group. This display can be toggled on and off with CTRL L and
saved in the parameter file with the D command.
DISKLIST provides a way for you to quickly select a format. F7
displays the Format Configuration Editor. Move the cursor to the
format you want and press F10. That will then be the format
selected to use in the command window.
-7-
You can also use the Format Configuration Editor to create a list
of formats that you want available from the control window. If,
for example, you only have a 3.5 inch diskette, then you do not
want to scan through all the selections for 5.25 inch drives.
Select or deselect the items you want with the space bar. Use
the cursor keys to move around the list. Press F10 when done.
Save this configuration with the D key from the control window.
Use the 8.5 x 11 format to list the files on your hard drive and
put the pages in a notebook for reference.
NONLASER PRINTER CONTROL CODES
DISKLIST has a generic set of nonlaser (dot matrix) printer
control codes. It only uses the codes to switch to and from
compressed (17 characters per inch) and regular (10 characters
per inch), and between 6 and 8 lines per inch for the compressed
printer modes. The default generic printer control codes work on
many printers and have been tested on the Epson FX-86e and IBM
Proprinter II.
DISKLIST provides a nonlaser printer code editor. It is
activated with the C command or directly with F5. Use it to
install your printer control codes for these functions if the
default codes do not work with your printer. It is easy to do
this with information supplied in your printer manual. Save the
printer control codes in the same file with the other DISKLIST
parameters with the D command in the control window.
When you enter the editor to change the printer codes, this
window will pop up. The figure illustrates an example when key 1
was pressed to change the codes for compressed on.
NONLASER PRINTER CODES
======================================
1 - Compressed ON 15
2 - 8 Lines per Inch 27, 48
3 - Compressed OFF 18
4 - 6 Lines per Inch 27, 50
======================================
1 to 4 - Enter the Decimal Codes
D - Restore the Default Codes
R - Restore Before Entry Codes
C - Clear All Codes
F10 - Quit and Use these Codes
======================================
Enter the codes for Compressed ON
? 15,7,65
-8-
Printer manuals contain a section or appendix on printer
commands, software commands, or control codes. These codes are
sent from the computer to the printer by DISKLIST to change the
character size and line spacing.
If DISKLIST doesn't print the directory list in a conventional
format, use the nonlaser printer code editor to tell DISKLIST
what codes to send to your printer to make it print correctly.
Your printer manual may have the codes in three different
formats, ASCII, decimal, and hexadecimal. Only enter decimal
codes into DISKLIST. These are all numbers between the values of
0 to 127. There are usually 1 to 3 numbers for each function
being changed.
Enter all of the numbers for one function on one line and
separate the numbers with a space or comma. There is no program
limit to the number of control codes you may enter. The above
figure of the codes window illustrates how a new code is being
entered for the function Compressed On.
To delete the line of codes on the prompt line, press the ESC
key. DISKLIST will only accept numbers from 0 to 255. It will
ignore all other numbers and beep as it does. It will accept any
quantity of numbers for each function but will only display those
that fit in the window.
DISKLIST only transmits these codes to the printer when a
compressed mode is selected. See the table that defines the
print formats on or near page 7.
When data on the prompt line exceeds the width of the window,
then the prompt line scrolls horizontally. You can then scroll
the data horizontally with the cursor keys; the display window
shows only the numbers that fit in the window.
The D command on the Printer Codes window will restore the built
in codes that came with DISKLIST.
If you want to print the IBM graphic lines on a DISKLIST listing,
then you must select the IBM mode on your printer. Try printing
a directory list with the IBM lines selected in DISKLIST with the
Border Line Type parameter. If it does not print the IBM lines,
read your printer manual to locate the switch to flip to activate
this mode on your printer. This applies to dot matrix printers
only.
If you do not have a laser printer, you may delete the file
DISKLIST.LSR so DISKLIST doesn't have to read it.
-9-
LASER COMMANDS
DISKLIST has a set of laser commands for each format that are in
the file DISKLIST.LSR. It also has a laser command editor,
accessed with F6, so you can easily change them. The laser
commands are setup in the following categories:
Symbol
Spacing
Pitch & Point Size
Orientation
Top Margin
Lines per inch
Left Margin, Row
Reset
You can put any commands on any line. These categories are for
reference only. Just remember, when laser printer is selected,
DISKLIST concatenates all of the commands in the first 7
categories and sends them to the printer. After the list is
printed, DISKLIST sends the commands in the eighth category,
Reset. You don't have to have any laser commands, and there is a
key (F8) to delete all commands for a format. Or, you can delete
the file DISKLIST.LSR and that will clear out all of the commands
and DISKLIST will still run.
Laser commands are all printable ASCII characters except ESC.
The IBM character set displays ESC as a left pointing arrow. So
does DISKLIST. To enter ESC on the command line, just press the
ESC key. Now, since the ESC key is used for input, how do you
get out of the editor? Press Function Key 10. To be consistent,
DISKLIST will quit all functions when F10 is pressed.
There is a space after ESC in this documentation for clarity. In
the actual HP laser command there is no space. In the laser
command editor the ESC is displayed as a left arrow with no
space.
The laser editor has the following functions:
F1 - Help
F2 - Copy to Pass Buffer
F3 - Insert from Pass Buffer
F6 - Insert Default Commands
F7 - Clear Active Command Line
F8 - Clear All Commands for this size
F9 - Save All Commands for all sizes
F10 - EXIT
When in the laser editor, you may change to another format with
F11 & F12, or ALT or Control with the left and right arrows.
-10-
The file DISKLIST.LSR is an ASCII file. It can be edited with a
text word processor like PC-WRITE. Each format has an ID number.
These numbers and the format name are written to the file so you
can locate the commands. When DISKLIST reads this file, it uses
the ID number to identify the format, but it ignores the name.
It only needs the commands for the formats that you want to use,
and the formats do not have to be in sequence in this file.
The default laser commands include a reset command ESC E with the
symbol command ESC (10U. The HP reset command is ESC E. If you
want to print more than one list on a page, then remove both of
the reset commands (ESC E) because it forces a form feed. You
may then force a form feed with E for Eject Page or CTRL R from
the control window. CTRL R sends the laser command ESC E to the
printer. So does CTRL E, ALT R, & ALT E.
The top margin command is ESC &l#E. That is a lowercase L before
the # sign and not the number 1. Replace the # with the line
number of the top line of the label.
You may want to change the laser commands that control the
position of the left margin and row. The default commands for
these are ESC &a0l0R. Again that is a lower case L between two
numeric zeros. These define the upper left corner of the list.
Replace the first zero with the number of the column to start the
list (left margin) and the second with the line number (row).
Laser commands that you may want to change to adjust where the
label is printed are the left margin and row. The default
commands for these are ESC &a0l0R. Again that is a lower case l
between two numeric zeros. These define the upper left corner of
the list. Replace the first zero with the number of the column
to start the list (left margin) and the second with the line
number (row).
F2 and F3 operate a pass buffer. They are used to copy the laser
commands one format to another. F2 copies the laser commands
from the displayed format to the pass buffer. Select another
format, press F3 and the laser commands from the pass buffer are
copied to this format.
F9 saves all the laser commands to the file DISKLIST.LSR. F6
will replace all the laser cammands for one format with the
default laser commands that were originally in DISKLIST.LSR.
DISKLIST prints the disk volume name and the title in bold
italic. If the font does not have bold italic, the printer will
print normal. The command that is sent for bold italic is
ESC (s1s7B and to return to normal, ESC (s0s0B. These commands
are coded into DISKLIST and you can't change them easily. If
this causes problems with any printer, please let me know and I
will fix the problem.
-11-
If you are only going to use DISKLIST with a laser printer, I
suggest that you remove all nonlaser printer codes. See the
previous section on Nonlaser Printer Control Codes. Use the C
command to clear all codes then exit. Select Laser Printer for
item 5 on the Control Window then press D to save the parameters.
This will prevent the accidental sending of nonlaser codes to a
laser printer.
See the file DISKLASR.DOC for additional information on laser
commands.
LASER DOWNLOAD
DISKLIST will download your soft fonts for you. Here's how.
Create an ASCII file with a text editor or word processor. Name
this file DISKLIST.FNT. Insert the DOS file name and a
description of the font. Place a comma after the DOS file name.
You may enter up to 10 names, each must be on a different line.
Example:
CO085R16.USP, Courier 8.5 Point 16.6 Pitch
RO100R12.UPS, Times Roman 10 Point 12 Pitch
Copy your font files and DISKLIST.FNT to the directory with
DISKLIST.EXE. Fonts do not come with DISKLIST.
The download section is accessed by pressing F3 from the Control
window, or selection 5 from the configuration window. DISKLIST
will display the file names and fonts and you select the one to
download. DISKLIST will download the font and select it. The HP
command codes that DISKLIST uses are given in the file
DISKLIST.LZR.
You may have to change the laser commands, particularly the Lines
per inch, to properly utilize this font, or delete them all with
F8. You may also want to change the Lines per List, parameter 8
in the Command window.
TEXT INPUT
There are several prompts where DISKLIST asks for text input.
All follow these rules. DISKLIST always presents the previous
data in that field for you to edit if you wish. ESC will erase
the entire line. All standard editing features of the computer
are available: insert, delete, home, end, left and right arrows.
DISKLIST has a novel feature. If you want to enter more
characters than will fit into the input window, then DISKLIST
scrolls the text sideways. All data will not be displayed in the
-12-
text window, but it will be used. One exception is the filespec
input. It will truncate any input to eight characters before the
period and three after the period to comply with DOS standards.
When a title for a disk is entered, it will be displayed at the
bottom of the control window as illustrated by the text in the
control window display above, "The List Title is Displayed Here".
To reuse the title, save it with the S command. DISKLIST will
save it on the disk drive selected by parameter 1 on the control
window. Retrieve it the next time with the R command.
Press RETURN or the up or down arrow when you are finished with a
text input.
STATUS MESSAGES
Status messages are displayed in a pop up window. In some cases,
such as error messages, you are prompted to press any key to
continue. In other cases, such as completion messages, they are
displayed for a few seconds then go away. You do not have to
wait for these latter messages to go away before entering a
command.
When you are producing a list, DISKLIST will display the path and
file names as it prints them in a status window. Sometimes this
goes too fast to read, but the purpose is to let you know that
something is happening. DISKLIST will STOP PROCESSING a list IF
ANY KEY IS PRESSED and beeps to alert you that it stopped
prematurely.
DISKLIST requires 256 K of free memory and DOS 2.1 or later.
MONOCHROME MONITOR
The highlight of the selected parameter in the Control Window and
the Format Selection Window may not be visible on monochrome
monitors. To make it possible for such users to know which
parameter is selected, press M to toggle the display of arrows
before the item on and off.
-13-
SUMMARY OF NON-DISPLAYED COMMANDS.
M Toggles display arrows for monochrome monitors.
^B Toggles the blind command action beeper on/off.
^L Toggles display of Format data at bottom of screen.
^E Sends the laser printer reset command ESC E.
^R Sends the laser printer reset command ESC E.
^ means hold the Control Key down, then press the letter. You
may use the ALT key instead of the Control Key for these four
keys.
FILENAMES
The names and purpose of all DISKLIST system files are listed
below. There are no hidden files. Only the first four files are
distributed with DISKLIST. The next three are created by it, and
the last is created by you.
DISKLIST.EXE Program
DISKLIST.DOC Documentation
DISKLIST.LSR HP LaserJet Commands for each format
DISKLASR.DOC Additional documentation on laserjet commands
DISKLIST.PRM Saved program configuration & nonlaser
printer control codes
DISKLIST.TTL Disk title
DISKLIST.TXT Default file name or a list output to a disk
DISKLIST.FNT File containing names of your softfonts
-14-
DISKFLAP
Lists for 5.25 inch disks can be kept in the disk sleeve. Some
3.5 inch disks have plastic sleeves, but few people use them.
DISKLIST lists can be attached to a 3.5 inch disk in a way that
allows them to remain attached when inserted in most floppy
drives. The list can even be read when it is in horizontal
drives.
This is accomplished by tapping the list to the back of the
diskette with one small piece of tape placed along the edge of
the diskette that doesn't go into the drive. You then have a
list that stays attached to the diskette even when it is inserted
in the drive.
Edge of disk that
does not go into drive
_______=====________ _ <-----Masking Tape Hinge
| | | |\
| [] | | | \
| | | | \
| | | | \<------ List printed
| 0 | | | \ by DISKLIST
| | | | \ Printed side
| Front of | | | \ out
| 3.5 " disk | | | \
| | | | \
\___________________| |_|
Front View Side View
The tape only has to be 3/4 to 1 inch by 1/2 inch. When you cut
the list out, leave about 1/4 inch of paper above the printed
frame of the list. Place the list on the back of the disk with
the top edge of the list along the back edge of the disk,
printed side out. Tape the list to the disk.
The tape acts as a hinge so the list can fold against the disk
for storage, or fold straight out away from the disk when the
disk is inserted into the drive. Masking tape works best and the
list can be pulled from the tape to be replaced. Scotch tape
also works.
-15-
SHAREWARE
DISKLIST is NOT a public domain program. It is copyrighted and
distributed as Shareware. DISKLIST may be distributed on
bulletin boards, by computer user groups and by disk vendors.
DISKLIST.EXE, DISKLIST.DOC, and DISKLIST.LSR must be distributed
together and unaltered.
If after evaluating DISKLIST, you decide to use it or keep it for
when you will need it, then you MUST submit the registration fee.
The registration form must be printed from DISKLIST with the F
command.
When you register DISKLIST you will receive:
Telephone and mail support.
A copy of the latest version of DISKLIST
Removal of Registration Screen & reminders.
Skip the Help screen at start of the program.
Skip the Registration Form reminder at the end
of the program.
A loan amortization program with both the
BASIC source code and the compiled
program. No registration is required for
the amortization program.
Copies of PC-ACCOUNT and SHERLOCK for you
to try before registering.
You will also receive a free introductory membership certificate
to CompuServe with a $15.00 credit towards online time.
Your registered copy of DISKLIST will NOT display the initial
Shareware title screen, the registration reminders, or the
initial or laser command setup help screens.
Because I will send you all of this software, please indicate on
the registration form the size of the floppy disks that you can
use.
The registration fee is 25.00. Maryland residents add 5% state
sales tax ($1.25). Orders outside of the United States add $3
for postage & handling unless you are sending $25 in travelers
checks. All checks and money orders must be in US funds and
drawn on a US bank. Visa or MasterCard may be used.
Most copies of software on bulletin boards and even in software
vendor libraries are not the latest version. It takes a long
time for these to get around, and most of the effort is placed on
the widest distribution of the initial release. And with so much
emphases being placed on 'safe software' these days, where is
there a more reliable place to obtain your software than directly
from an ASP author.
-16-
The following is the schedule of the multi-copy license fees.
The fee includes one master diskette which you may then copy and
use on the number of machines listed below:
# Users Price
------- -------
5 $ 100.00 ($20 per copy)
10 140.00 ($19 per copy)
25 425.00 ($17 per copy)
50 750.00 ($15 per copy)
100 1,200.00 ($12 per copy)
Site 2,500.00
For corporate, educational institution, and network discounts,
contact Gulf Sierra.
Once in a while DISKLIST will act like it is registered for non
registered users. It starts running without the shareware screen
and displays a window with the message 'Will Run as if
REGISTERED' just to show you how it will run when registered.
EPILOGUE
Please report discrepancies (bugs) that you find in DISKLIST.
Include sufficient information for me to replicate the incident.
When I correct a bug, the person who reported it gets the first
copy.
Whenever you write, please include your home phone number. You
can also send CompuServe mail to me. My CompuServe ID is
73270,77. I usually answer questions by phone on the weekend or
early in the evening Eastern time.
If you do not like DISKLIST, please let me know that you tried it
and, if you wish, why you will not use it again. Tell me what
features would have made DISKLIST useful to you. Perhaps you had
a problem because I didn't clearly convey how to use it. Many
features in my software were suggested by people who did not
register. And of course, many more were suggested by those who
did. You may use the registration form to reply and cross out
the word Registration.
COMMERCIAL LABELS
One company that produces stick on labels for both form fed
printers and laser printers is Avery. These labels are available
from many office supply stores and catalogs. The form fed labels
work very well. The laser labels are difficult to use because
you must set the left margin and row for each label on the sheet.
There are nine 3.5 and twelve 5.25 disk labels to a sheet. Avery
-17-
says a laser sheet can only be run through the printer once. A
future version of DISKLIST may automatically position the
printing of laser labels so that many lists can be printed on one
sheet. Let me know if you want that.
The Avery disk labels are: Catalog
Label Size Number
For 3.5" disks and form fed printers 2.75 x 2.75 4241
For 5.25" disks and form fed printers 1.25 x 4.75 4240
For 3.5" disks and laser printers 2.75 x 2.75 5196
For 5.25" disks and laser printers 1.50 x 4.00 5197
OMBUDSMAN
I am a member of the Association of Shareware Professionals
(ASP). ASP wants to make sure that the Shareware principle works
for you. If you are unable to resolve a Shareware-related
problem with an ASP member by contacting the member directly, ASP
may be able to help.
The ASP Ombudsman can help you resolve a dispute or problem with
an ASP member, but does not provide technical support for
members' products. Please write to the ASP Ombudsman at 545
Grover Road, Muskegon, MI 49442-9427 or send a CompuServe message
via CompuServe mail to ASP Ombudsman 70007,3536.
-18-
IBM GRAPHICS EXAMPLE
This is an example of another format for the DISKLIST output. It
can be seen on the computer screen and printed on a printer setup
for IBM graphics. If this figure is not framed in continuous
lines, then your printer is not setup for IBM graphics. Read your
printer manual to determine if it is possible to switch to that
mode. Otherwise, you can still use DISKLIST with the ASCII
character frame as illustrated on page 1.
┌────────────────────────────────────────────────┐
│ GREAT SHAREWARE │
│ Volume ID is DISKLIST │
│ 1,457,664 Total Space 893,440 Bytes Free │
├────────────────────────────────────────────────┤
│ A:\ 153,664 BYTES │
│ DISKLIST.DOC 34,377 08/15/90 19:32:16 │
│ DISKLIST.EXE 119,144 08/14/90 22:02:18 │
│ DISKLIST.PRM 124 03/25/90 11:11:48 │
│ DISKLIST.TTL 19 03/25/90 11:05:06 │
│ │
│ A:\PC-ACCOU.NT 230,862 BYTES │
│ PCACT220.EXE 156,150 11/08/89 19:03:52 │
│ PCACT220.TXT 6,838 11/09/89 18:30:42 │
│ PCDOC220.EXE 67,874 11/08/89 19:09:22 │
│ │
│ A:\SHERLOCK 175,967 BYTES │
│ SHERLOCK.DOC 30,895 08/15/90 19:35:14 │
│ SHERLOCK.EXE 145,072 08/15/90 19:44:04 │
├────────────────────────────────────────────────┤
│ 9 Files 08-17-1990 18:46:20 │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│ Created by DISKLIST │
└────────────────────────────────────────────────┘
This is shown in the 5.25 inch normal format. DISKLIST can also
print it in 32 other formats.
-19-